-- *****************************************************************
-- REDSTONE-LOG-MIB
--
-- Enterprise MIB
-- Extensions for Logging Management
--
-- Copyright 1999 Unisphere Solutions, Inc.
-- All Rights Reserved.
-- *****************************************************************--
-- Brief Description of Logging Facility Model
--
-- A system application may support one or more
-- logging categories. Each category can be separately
-- configured for severity and verbosity levels of the
-- logging messages it generates in reponse to category-
-- specific events. The severity level filters the generation
-- of messages; the verbosity level controls the content of
-- each generated message. Each category is resource-limited
-- in the rate of messages it can generate, thus high
-- event volume in one category will not exhaust common
-- resources to the extent that other log categories
-- are starved.
--
-- Generated log messages are recorded into a central
-- circular repository, called the log message table.
-- Each such recorded message is examined and can be
-- sent to as many as three logging destinations:
-- network-based SYSLOG server; local console; and local
-- nonvolatile log file. Each of these destinations is
-- separately configurable for severity level of messages
-- it wishes to receive.
--REDSTONE-LOG-MIB DEFINITIONS::=BEGINIMPORTSMODULE-IDENTITY,
NOTIFICATION-TYPE,OBJECT-TYPE,Integer32,Counter32,Unsigned32,IpAddressFROM SNMPv2-SMI
TEXTUAL-CONVENTION,DisplayString,RowStatus,TruthValue,TimeStamp,DateAndTimeFROM SNMPv2-TC
MODULE-COMPLIANCE,OBJECT-GROUPFROM SNMPv2-CONF
rsMgmt
FROM REDSTONE-SMI
RsEnable,
RsLogSeverity
FROM REDSTONE-TC;rsLogMIB MODULE-IDENTITYLAST-UPDATED"9912310000Z"ORGANIZATION"Unisphere Solutions Inc."CONTACT-INFO"
Unisphere Solutions, Inc.
5 Carlisle Road
Westford MA 01886
USA
Tel: +1-978-692-1999
Email: mib@redstonecom.com
"DESCRIPTION"The Log MIB for the
Redstone Communications Inc. enterprise."REVISION"9912310000Z"DESCRIPTION"Actually 27-Mar-2000. Replace single syslog destination
with table of syslog destinations, and add syslog facility
as an attribute for syslogs."REVISION"9911080000Z"
DESCRIPTION"Revise hierarchy of trap subtree so that MIB root node is
enterprise for traps defined in this MIB. Rename logMsgCount
to be logMsgLastSeqNumber."REVISION"9909290000Z"DESCRIPTION"Initial version of this MIB module."::={ rsMgmt 28}-- ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
-- Textual conventions
-- ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++RsLogCatName ::=TEXTUAL-CONVENTIONSTATUScurrentDESCRIPTION"The name of a log category."SYNTAXDisplayString(SIZE(1..32))
RsLogVerbosity ::=TEXTUAL-CONVENTIONSTATUScurrentDESCRIPTION"The log verbosity level. Not all event types
offer medium- or high-verbosity levels of detail."SYNTAXINTEGER{low(0),medium(1),high(2)}RsLogSyslogFacility ::=TEXTUAL-CONVENTIONSTATUScurrent
DESCRIPTION"The syslog daemon facility id."SYNTAXINTEGER{local0(0),local1(1),local2(2),local3(3),local4(4),local5(5),local6(6),local7(7)
}-- ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
-- Managed objects
-- ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++rsLogObjects OBJECTIDENTIFIER::={ rsLogMIB 1}rsLogDestinations OBJECTIDENTIFIER::={ rsLogObjects 1}rsLogCategories OBJECTIDENTIFIER::={ rsLogObjects 2}rsLogMessages OBJECTIDENTIFIER::={ rsLogObjects 3}
-- :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
-- Log Destinations
-- :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::rsLogDestSyslog OBJECTIDENTIFIER::={ rsLogDestinations 1}rsLogDestConsole OBJECTIDENTIFIER::={ rsLogDestinations 2}rsLogDestNvFile OBJECTIDENTIFIER::={ rsLogDestinations 3}--
-- SYSLOG server log destination
--
-- Scalar objects supporting a single syslog destination
-- are obsoleted in favor of a table of syslog destinations.
--rsLogDestSyslogSeverity OBJECT-TYPE
SYNTAX RsLogSeverity
MAX-ACCESSread-writeSTATUSobsoleteDESCRIPTION"The minimum severity level of messages sent to the
SYSLOG server. A value of 'off' indicates no log
messages are sent to this destination."::={ rsLogDestSyslog 1}rsLogDestSyslogAddress OBJECT-TYPESYNTAXIpAddressMAX-ACCESSread-writeSTATUSobsoleteDESCRIPTION"The IP address of the SYSLOG server to which
log messages are to be sent. A value of 0.0.0.0
indicates no server address is configured."::={ rsLogDestSyslog 2}
rsLogSyslogTable OBJECT-TYPESYNTAXSEQUENCEOF RsLogSyslogEntry
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"A table describing the characteristics of each
syslog destination."::={ rsLogDestSyslog 3}rsLogSyslogEntry OBJECT-TYPESYNTAX RsLogSyslogEntry
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"An entry describingthe characteristics of a
syslog destination."
INDEX{ rsLogSyslogIpAddress }::={ rsLogSyslogTable 1}
RsLogSyslogEntry ::=SEQUENCE{
rsLogSyslogIpAddress
IpAddress,
rsLogSyslogRowStatus
RowStatus,
rsLogSyslogSeverity
RsLogSeverity,
rsLogSyslogFacility
RsLogSyslogFacility
}rsLogSyslogIpAddress OBJECT-TYPESYNTAXIpAddressMAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"The IP address of this syslog destination.
This value must be a unicast IP address."
::={ rsLogSyslogEntry 1}rsLogSyslogRowStatus OBJECT-TYPESYNTAXRowStatusMAX-ACCESSread-createSTATUScurrentDESCRIPTION"Controls creation/deletion of entries in this table.
Only 'createAndGo' and 'destroy' are supported."::={ rsLogSyslogEntry 2}rsLogSyslogSeverity OBJECT-TYPESYNTAX RsLogSeverity
MAX-ACCESSread-createSTATUScurrentDESCRIPTION"The severity level for this syslog destination.
Setting this value to 'off' suppresses log messages
from being sent to this syslog destination."DEFVAL{ off }::={ rsLogSyslogEntry 3}rsLogSyslogFacility OBJECT-TYPESYNTAX RsLogSyslogFacility
MAX-ACCESSread-createSTATUScurrentDESCRIPTION"The facility id attached to messages sent to this
syslog destination."DEFVAL{ local7 }::={ rsLogSyslogEntry 4}--
-- Local console log destination
--rsLogDestConsoleSeverity OBJECT-TYPE
SYNTAX RsLogSeverity
MAX-ACCESSread-writeSTATUScurrentDESCRIPTION"The minimum severity level of messages sent to the
console. A value of 'off' indicates no log messages
are sent to this destination."::={ rsLogDestConsole 1}--
-- Local nonvolatile file log destination
--rsLogDestNvFileSeverity OBJECT-TYPESYNTAX RsLogSeverity
MAX-ACCESSread-writeSTATUScurrentDESCRIPTION"The minimum severity level of messages sent to the
nonvolatile log file. A value of 'off' indicates
no log messages are to be sent to this destination."
::={ rsLogDestNvFile 1}-- :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
-- Log Categories
-- :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::rsLogCatScalars OBJECTIDENTIFIER::={ rsLogCategories 1}-- reserved for attributes pertaining to all logs--
-- Log Category Table
--rsLogCatTable OBJECT-TYPESYNTAXSEQUENCEOF RsLogCatEntry
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"A table describing the characteristics of each log category."
::={ rsLogCategories 2}rsLogCatEntry OBJECT-TYPESYNTAX RsLogCatEntry
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"An entry describing the characteristics of a log category."INDEX{ rsLogCatIndex }::={ rsLogCatTable 1}
RsLogCatEntry ::=SEQUENCE{
rsLogCatIndex
Integer32,
rsLogCatName
RsLogCatName,
rsLogCatDescr
DisplayString,
rsLogCatEngineering
TruthValue,
rsLogCatDiscards
Counter32,
rsLogCatSeverity
RsLogSeverity,
rsLogCatVerbosity
RsLogVerbosity
}rsLogCatIndex OBJECT-TYPESYNTAXInteger32(1..2147483647)MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"An integer index uniquely associated with a log.
Index values do not necessarily persist across system
reboots. Following reboot, mappings of (reboot-invariant)
log category names to log index values is available in
the rsLogCatNameTable."::={ rsLogCatEntry 1}
rsLogCatName OBJECT-TYPESYNTAX RsLogCatName
MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The name of this log category."::={ rsLogCatEntry 2}rsLogCatDescr OBJECT-TYPESYNTAXDisplayStringMAX-ACCESSread-onlySTATUScurrentDESCRIPTION"A description of the functionality for which events
are recorded by this log category."::={ rsLogCatEntry 3}
rsLogCatEngineering OBJECT-TYPESYNTAXTruthValueMAX-ACCESSread-onlySTATUScurrentDESCRIPTION"An indication of whether this log is intended mainly
for engineering development and debug purposes."::={ rsLogCatEntry 4}rsLogCatDiscards OBJECT-TYPESYNTAXCounter32MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The number of messages generated by this log category
that were discarded because of resource limitations."
::={ rsLogCatEntry 5}rsLogCatSeverity OBJECT-TYPESYNTAX RsLogSeverity
MAX-ACCESSread-writeSTATUScurrentDESCRIPTION"The severity level for this log category.
The value 'off' disables recording of this log category's
messages. For other severity level values, only messages
at or above this severity level will be logged in rsLogMsgTable."::={ rsLogCatEntry 6}rsLogCatVerbosity OBJECT-TYPESYNTAX RsLogVerbosity
MAX-ACCESSread-writeSTATUScurrentDESCRIPTION
"The verbosity level for this log category.
Supplementary information may be available for certain
event types. This object controls whether that additional
information, if available for a given event, is recorded."::={ rsLogCatEntry 7}--
-- Log Category Name Table
--rsLogCatNameTable OBJECT-TYPESYNTAXSEQUENCEOF RsLogCatNameEntry
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"A table mapping each log category's name to its index."::={ rsLogCategories 3}rsLogCatNameEntry OBJECT-TYPE
SYNTAX RsLogCatNameEntry
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"An entry mapping a log category's name to its index."INDEX{IMPLIED rsLogCatNameName }::={ rsLogCatNameTable 1}
RsLogCatNameEntry ::=SEQUENCE{
rsLogCatNameName
RsLogCatName,
rsLogCatNameIndex
Integer32}rsLogCatNameName OBJECT-TYPESYNTAX RsLogCatName
MAX-ACCESSread-onlySTATUScurrent
DESCRIPTION"The name of the log category."::={ rsLogCatNameEntry 1}rsLogCatNameIndex OBJECT-TYPESYNTAXInteger32(1..2147483647)MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The log index associated with this log category."::={ rsLogCatNameEntry 2}-- :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
-- Log Messages
-- :::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
--
-- Log Message Scalars
--rsLogMsgScalars OBJECTIDENTIFIER::={ rsLogMessages 1}rsLogMsgCapacity OBJECT-TYPESYNTAXInteger32UNITS"messages"MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The maximum capacity, in number of log messages, of
the rsLogMsgTable."::={ rsLogMsgScalars 1}rsLogMsgLastSeqNumber OBJECT-TYPESYNTAXCounter32MAX-ACCESSread-only
STATUScurrentDESCRIPTION"The sequence number of the most recent rsLogMsgTable entry.
By monitoring this object's rate of change in relation to
the rsLogMsgTable capacity, a management client can determine
whether it is polling rsLogMsgTable frequently enough to avoid
missing log messages."::={ rsLogMsgScalars 2}--
-- Log Message Table
--rsLogMsgTable OBJECT-TYPESYNTAXSEQUENCEOF RsLogMsgEntry
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"A table of log messages generated by this device."::={ rsLogMessages 2}
rsLogMsgEntry OBJECT-TYPESYNTAX RsLogMsgEntry
MAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"A log message generated by this device."INDEX{ rsLogMsgSysUpTimeStamp, rsLogMsgSequenceNumber }::={ rsLogMsgTable 1}
RsLogMsgEntry ::=SEQUENCE{
rsLogMsgSysUpTimeStamp
TimeStamp,
rsLogMsgSequenceNumber
Unsigned32,
rsLogMsgCatName
RsLogCatName,
rsLogMsgCatIndex
Integer32,
rsLogMsgSeverity
RsLogSeverity,
rsLogMsgText
DisplayString,
rsLogMsgDateAndTimeStamp
DateAndTime}rsLogMsgSysUpTimeStamp OBJECT-TYPESYNTAXTimeStampMAX-ACCESSnot-accessibleSTATUScurrentDESCRIPTION"The value of sysUpTime when this log message was recorded."::={ rsLogMsgEntry 1}rsLogMsgSequenceNumber OBJECT-TYPESYNTAXUnsigned32MAX-ACCESSnot-accessible
STATUScurrentDESCRIPTION"A sequence number that uniquely identifies this entry. Sequence
numbers are assigned consecutively beginning with 1. More recent
entries have higher sequence numbers."::={ rsLogMsgEntry 2}rsLogMsgCatName OBJECT-TYPESYNTAX RsLogCatName
MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"Name of the log category that contributed this message."::={ rsLogMsgEntry 3}rsLogMsgCatIndex OBJECT-TYPESYNTAXInteger32
MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"Index of the log category that contributed this message."::={ rsLogMsgEntry 4}rsLogMsgSeverity OBJECT-TYPESYNTAX RsLogSeverity
MAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The severity of the message."::={ rsLogMsgEntry 5}rsLogMsgText OBJECT-TYPESYNTAXDisplayStringMAX-ACCESSread-only
STATUScurrentDESCRIPTION"The text of the log message.
Truncation of log message text is indicated by
n asterisk character ('*') in the last octet of
a maximum-size string."::={ rsLogMsgEntry 6}rsLogMsgDateAndTimeStamp OBJECT-TYPESYNTAXDateAndTimeMAX-ACCESSread-onlySTATUScurrentDESCRIPTION"The date and time this message was generated."::={ rsLogMsgEntry 7}-- ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
-- Notification control objects
-- ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++rsLogTrapControl OBJECTIDENTIFIER::={ rsLogMIB 2}rsLogMsgThreshold OBJECT-TYPESYNTAXInteger32(0..100)UNITS"percent"MAX-ACCESSread-writeSTATUScurrentDESCRIPTION"Number of log messages which, when added to rsLogMsgTable,
cause a rsLogMsgThresholdTrap to be generated.
This value is expressed as a percentage of the capacity of
rsLogMsgTable. A value of zero disables trap generation."
::={ rsLogTrapControl 1}-- ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
-- Notifications
-- ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++-- The following OBJECT IDENTIFIERS is used to define SNMPv2
-- Notifications that are easily translated into SNMPv1 Traps.rsLogTrapPrefix OBJECTIDENTIFIER::={ rsLogMIB 0}rsLogMsgThresholdTrap NOTIFICATION-TYPEOBJECTS{
rsLogMsgCapacity,
rsLogMsgLastSeqNumber,
rsLogMsgThreshold
}STATUScurrentDESCRIPTION
"This trap is generated to report that an incremental number
of log messages (described by the value of rsLogMsgThreshold)
have been added to rsLogMsgTable."::={ rsLogTrapPrefix 1}-- ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
-- Conformance information
-- ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++rsLogMIBConformance
OBJECTIDENTIFIER::={ rsLogMIB 4}rsLogMIBCompliances
OBJECTIDENTIFIER::={ rsLogMIBConformance 1}rsLogMIBGroups
OBJECTIDENTIFIER::={ rsLogMIBConformance 2}
-- compliance statementsrsLogCompliance MODULE-COMPLIANCESTATUSobsoleteDESCRIPTION"The compliance statement for entities which implement
the Unisphere Solutions Inc. Log MIB."MODULE-- this moduleMANDATORY-GROUPS{ rsLogGroup }::={ rsLogMIBCompliances 1}rsLogCompliance2 MODULE-COMPLIANCESTATUScurrentDESCRIPTION"The compliance statement for entities which implement
the Unisphere Solutions Inc. Log MIB., including support
for multiple SYSLOG destinations."MODULE-- this moduleMANDATORY-GROUPS{ rsLogGroup2 }::={ rsLogMIBCompliances 2}-- units of conformancersLogGroup OBJECT-GROUPOBJECTS{-- log destinations
rsLogDestSyslogSeverity,
rsLogDestSyslogAddress,
rsLogDestConsoleSeverity,
rsLogDestNvFileSeverity,-- log categories
rsLogCatName,
rsLogCatDescr,
rsLogCatEngineering,
rsLogCatDiscards,
rsLogCatSeverity,
rsLogCatVerbosity,-- log category names
rsLogCatNameName,
rsLogCatNameIndex,-- log message scalars
rsLogMsgCapacity,
rsLogMsgLastSeqNumber,-- log messages
rsLogMsgCatName,
rsLogMsgCatIndex,
rsLogMsgSeverity,
rsLogMsgText,
rsLogMsgDateAndTimeStamp,-- trap control
rsLogMsgThreshold
}STATUSobsoleteDESCRIPTION"A collection of objects providing management of
Unisphere Solutions Inc. logging capabilities."::={ rsLogMIBGroups 1}
rsLogGroup2 OBJECT-GROUPOBJECTS{-- log destinations
rsLogSyslogRowStatus,
rsLogSyslogSeverity,
rsLogSyslogFacility,
rsLogDestConsoleSeverity,
rsLogDestNvFileSeverity,-- log categories
rsLogCatName,
rsLogCatDescr,
rsLogCatEngineering,
rsLogCatDiscards,
rsLogCatSeverity,
rsLogCatVerbosity,-- log category names
rsLogCatNameName,
rsLogCatNameIndex,-- log message scalars
rsLogMsgCapacity,
rsLogMsgLastSeqNumber,-- log messages
rsLogMsgCatName,
rsLogMsgCatIndex,
rsLogMsgSeverity,
rsLogMsgText,
rsLogMsgDateAndTimeStamp,-- trap control
rsLogMsgThreshold
}STATUScurrentDESCRIPTION"A collection of objects providing management of
Unisphere Solutions Inc. logging capabilities,
including support for multiple SYSLOG destinations."::={ rsLogMIBGroups 2}END